home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 4 / ETO Development Tools 4.iso / Tools - Objects / Virtual User 1.0 / Release Notes 1.0 < prev    next >
Text File  |  1991-01-25  |  12KB  |  258 lines
  1.  
  2.  
  3.                 Virtual User 1.0 Release Notes
  4.  
  5.  
  6. This is the 1.0 final release of the Virtual User (VU) test automation 
  7. system. If you are updating VU from 1.0b5 release then please use 
  8. the Mark menu and go to the section on 'Things that have changed'.
  9.  
  10. This release package comes in the form of two 800K disks and four
  11. documents. The documents are as follows:
  12.  
  13. 1.    Getting Started with Virtual User:  The first time user is 
  14.     suggested to start by reading this document. This gives you a 
  15.     road map to the rest of the documents.
  16.     
  17. 2.    Virtual User General Reference:  This describes the 
  18.     general architecture of the system and how to make effective use
  19.     of it for test automation.
  20.  
  21. 3.    Virtual User Language Reference: This is a reference manual for 
  22.     the scripting language that has been designed to specify VU-driven
  23.     tests.
  24.  
  25. 4.    Virtual User Release Notes (for 1.0)
  26.  
  27. 5.    VU Recorder Reference Manual: This describes the sister application
  28.     VU Recorder which can be used to augment the utility of VU.  The 
  29.     Virtual User General Reference has a chapter on how to use VU Recorder
  30.     in conjunction with VU.
  31.  
  32. The two disks are as follows:
  33.  
  34. 1.    Virtual User Program: This disk contains the Virtual User system which 
  35.     is comprised of the following main items.  The Virtual User General
  36.     Reference describes how to install VU on your machine using the contents
  37.     of this disk.
  38.  
  39. •    Virtual User folder: VU, the MPW tool which runs the VU scripts, is
  40.     located here.  Other items in this folder are used to set up a VU 
  41.     environment in MPW.
  42.  
  43. •    Agent VU: This is the system Init which sits in the test machine's 
  44.     system folder.
  45.  
  46. •    Supplements: This folder contains other supplementary items like 
  47.     VU Recorder, special items needed to test MacApp applications, etc.
  48.  
  49. 2.    Virtual User Samples: This disk provides you with some example VU
  50.     scripts and some example libraries to get you started.  Each of the 
  51.     example scripts has a header which describes its purpose and the setup
  52.     required to run it.
  53.  
  54.  
  55. VU Installation
  56.  
  57. To be able to use Virtual User you must start by reading the Getting Started
  58. With Virtual User document. This document describes the system, its
  59. installation procedure and other facts you must know to start using VU. 
  60.  
  61.  
  62. Things that have changed
  63.  
  64. We have fixed some problems found in the previous version (1.0b5). As a 
  65. result the following components of the system has changed since the last
  66. release:
  67. Virtual User Program (Disk 1) -
  68. VU (the MPW tool), Agent VU, Startup, InstallVUHelp, MPW Scripts folder,
  69. and the MacApp Hook folder in the Supplements folder.
  70. Virtual User Samples (Disk 2) -
  71. Example Scripts and Example Libraries.
  72.  
  73. Following is a list of problems that have been fixed:
  74.  
  75. 1.    When you abort VU using cmd-. while a test is in progress, VU 
  76.     now responds much quicker. 
  77.  
  78. 2.    Aborting a script during a typing operation on a target sometimes 
  79.     caused the last typed key to remain in the key down position.  This
  80.     should now happen much less frequently.
  81.  
  82. 3.    VU now allows you to type using the numeric keypad as follows:
  83.  
  84.         type k:{1} p:true; #the 'p' arg specifies use of the numeric keypad
  85.  
  86.     If p:false then the numeric keypad will not be used. If you do not
  87.     specify the 'p' arg at all then VU may or may not use the numeric keypad,
  88.     i.e.
  89.  
  90.         type k:{1}; #this Does NOT ensure either 'use' or 'not use' keypad
  91.     
  92.     Please note that use of the 'p' argument is optional. Any old scripts
  93.     which did typing will continue to run (but may not make use of the
  94.     numeric keypad).
  95.  
  96. 4.    No hierarchical menu item selection problem should occcur (there are 
  97.     some stray cases when VU might have problems theoretically, but in
  98.     practice we should normally not encounter such cases at all).
  99.  
  100. 5.    VU should work against the new keyboards and recognize them when you do
  101.     match [keyboard]. Note that the target has to be running System 6.0.7 for
  102.     this to work.
  103.  
  104. 6.    When you do match [target], VU should recognize the newer systems Mac IIfx,
  105.     MacIIsi, MacLC and Classic (the n: trait should have correct value).
  106.  
  107. 7.    You should be able to type against most international systems properly 
  108.     although you may have to add the KCHR resources from the target system
  109.     to VU's resource fork on the host.  Refer to the the Chapter "Running 
  110.     Virtual User Against International Systems" in the Virtual User General
  111.     Reference for details.
  112.     
  113. 8.    Menu selections from the System 7.0 Label menu will now work properly.
  114.  
  115.  
  116. Things to note
  117.  
  118.  •    MacApp Support 
  119.     Virtual User has problems running against MacApp applications due to
  120.     reasons described in the chapter  “Running VU Against Applications built 
  121.     with MacApp” in the Virtual User General Reference document.  We provide
  122.     an Agent VU hook for MacApp applications to enable the application to
  123.     become VU friendly.  You will have to build your MacApp application with 
  124.     this hook to be able to test it with VU successfully.  The source code
  125.     for the hook and the accompanying document are available in the 
  126.     Supplements folder in the Virtual User Program disk.  A sample application
  127.     built using this hook and a VU script which runs against it is available
  128.     in the Virtual User Samples disk.
  129.  
  130. •    Popup Support
  131.     We have implemented support for popup menu selections and matching for 
  132.     those applications that use the CDEF (CDEF id = 63) which comes with 
  133.     System 7.0 or the one which the Macintosh Communication Toolbox uses. 
  134.     Please contact Apple Software Licensing regarding the use of the 
  135.     Communication Toolbox CDEF.  It is not possible to retrofit applications
  136.     that use the scheme outlined in Inside Mac vol. V.
  137.  
  138. •    Warnings for reserved word use
  139.     We are trying to safeguard against possible name conflicts with future
  140.     versions of VU.  VU will now warn against the use of a particular name
  141.     (e.g. variable, task name) that may conflict with our future plans.
  142.     This will not prevent you from using it now as there are no semantics
  143.     tied to those words at present.  If you want to know whether a particular
  144.     script has any names that may conflict with the future without actually 
  145.     executing the script, you can use the compile only option (-c).
  146.  
  147.  
  148. Known Problems
  149.  
  150. 1.    Task definitions with task calls in the default values for their 
  151.     arguments do not work properly.  For example,
  152.  
  153.         task test (arg1 := foo()) begin…end; 
  154.  
  155.     where foo() is a task call.  The task call given as the default argument
  156.     will always evaluate to undefined.
  157.  
  158. 2.    The grow trait for windows may be reported to be true when the window has
  159.     no visible grow box.  This occurs with windows which are technically
  160.     document windows with grow boxes, but which choose not to draw the grow
  161.     box.  There is no known problem with the reverse case, which is to say VU
  162.     will not indicate that a window lacks a grow box when it really has one.
  163.  
  164. 3.    VU will erroneously report that it has lost contact with its target if a
  165.     matching operation is attempted while the target's mouse button is
  166.     pressed in the menubar, a window's title bar, grow box, any control, or
  167.     a menu selection is in progress.  This problem arises when the target
  168.     mouse is operated with the primitive mouse operation pressMouse and no
  169.     corresponding releaseMouse command is given before matching is attempted
  170.     or when some person holds the mouse button down while VU is operating
  171.     the target.  At present, there is no fix available to us for this problem.
  172.  
  173. 4.    There may be problems with situations where VU will be reading the items
  174.     out of one dialog (with help from Agent VU) and a new dialog appears in
  175.     front of the one VU is reading.  VU continues to read dialog items, but
  176.     it is getting them from the new front most dialog.  The effect is to
  177.     create a window descriptor whose content list is a mixture of both
  178.     dialogs.  An example where this might happen is with printer dialogs.
  179.  
  180. 5.    Typed keys on target machines may be repeated when running on busy
  181.     networks. This problem may be eliminated by making sure that key repeat
  182.     is set to off with the Keyboard control panel on each target.
  183.  
  184. 6.    The screen size of a target may be improperly reported if a system is
  185.     transferred across machine types.  For example, if a system running on a
  186.     Mac SE had previously been running on a Mac II with a color monitor, the
  187.     screen size of the color monitor will most likely be reported.  If the
  188.     system is transferred to a machine with a configurable monitor setup,
  189.     this problem can be corrected by running the Monitors control panel.
  190.     Otherwise, the workaround is to install systems specifically for the
  191.     machine on which it will be running.
  192.  
  193. 7.    Under System 7.0a9, the location of content items in control panel
  194.     windows and in the Chooser will be skewed in relation to their real
  195.     on-screen location.  This will be fixed at least for control panel
  196.     windows in upcoming developer-seeded versions of System 7.0.
  197.     
  198. 8.    Due to the special input methods required, Virtual User does not directly 
  199.     support multibyte character typing operations on international systems which 
  200.     have multibyte character sets.
  201.     
  202. 9.    Virtual User does not support the keycode remapping which is done on certain 
  203.     keys via an 'itlk' resource in some international systems. As a result, 
  204.     certain characters may not type properly on targets running international 
  205.     systems which use 'itlk' resources.
  206.     
  207. 10.    If the user specifies "EnterKey" to be typed in a script statement and the 
  208.     keypad argument is not specified, the keycode generated in the event record 
  209.     on the target will be $34.  This keycode cannot normally be generated on a 
  210.     Macintosh keyboard.  However, the correct ASCII value for enter, $03, is 
  211.     correctly specified.  Applications will not be affected by this unless they 
  212.     use the keycode.  The workaround is to specify that the keypad be used in 
  213.     the typing operation.  In this case, the keycode for the keypad enter key 
  214.     is specified correctly.
  215.     
  216. 11.    If the user specifies "EscapeKey" to be typed in a script statement and 
  217.     the keypad argument is set to true, the clear key, which has the same ASCII
  218.     value as the escape key, will be typed.  The workaround is to leave out the
  219.     keypad argument or set it to false.  In this case, the real escape key is hit.
  220.     
  221. 12.    When a modal dialog is up under System 7.0, menus appear disabled but they
  222.     can still be selected.  All corresponding menu items are disabled.  Virtual
  223.     User reports the enable state of the menus and menu items that existed just
  224.     BEFORE the modal dialog appeared.  In other words, menus and menu items which
  225.     were enabled before the modal dialog appeared will be reported as enabled 
  226.     while the modal dialog is up.
  227.     
  228. 13.    If a control in a window is for the most part obscured by a scroll bar, 
  229.     actions such as selection which are directed at the control will be received
  230.     by the scroll bar instead.
  231.  
  232.     
  233. Reporting Problems
  234.  
  235. To report problems, please use Outside Bug Reporter and/or link to MACDTS.  
  236.  
  237. The following is most helpful when reporting problems:
  238.  
  239. 1.    Version numbers for all components of Virtual User you are 
  240.     using.  You can obtain the version of VU by using the -vers 
  241.     command line option.
  242.  
  243. 2.    The smallest VU script that shows the problem.  In other words, try
  244.     to eliminate as much of the script as you can.  If it's one statement
  245.     that causes the problem, send us just that one statement.  Along with
  246.     the script, describe the target state in terms of what application
  247.     the script is running against and what state the app is in.
  248.  
  249. 3.    System configurations for both the target and the VU machine.
  250.  
  251. 4.    The network across which the test was being run.
  252.  
  253. Contact
  254.  
  255. There is a Virtual User forum for you on AppleLink®.  Please post your questions
  256. here.  The full path name to access it is:
  257. Developer Support:Developer Talk:Macintosh Development Tool Discussions:Virtual User Discussion
  258.